Home > Use Cases > Retrieving VMs List

Retrieving VMs List

A sample SessionToken will be used throughout this use case.
The sample SessionToken will be: e65aedeb-a0e7-440c-8309-1cc0bcd920db

The API can either retrieve a list of all Virtual Machines, that is, both Virtual Machines configured by Altaro VM Backup, as well as the Virtual Machines which reside on the Hypervisor but are not configured by Altaro VM Backup. A parameter can be provided to explicitly retrieve Virtual Machines which are configured by Altaro VM Backup. For configured VMs, the Response will contain detailed information regarding backups, such as the last backup time, last backup result, last backup size, next backup time, and so on.

 

The following GET request retrieves a list of all configured and un-configured Virtual Machines:

http://localhost:35113/api/vms/list/e65aedeb-a0e7-440c-8309-1cc0bcd920db

 

The following GET request retrieves a list of configured Virtual Machines by Altaro VM Backup:

http://localhost:35113/api/vms/list/e65aedeb-a0e7-440c-8309-1cc0bcd920db/1

 

Note: A full list of available API commands can be found here